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PREFACE 


1.0 Manual Objectives 


The PROGRAMMABLE DEVICE SUPPORT Software Installation 
Guide/Releas# Notes manual shows how to install PROGRAMMABLE 
DEVICE SUPPORT on VAX/VMS. 


2. 0 Audience 


This manual is intended for individuals responsible for 
setting up and maintaining the VAX/VMS operating system and 
PROGRAMMABLE DEVICE SUPPORT software. 


3. 0 Prerequisites 


Readers of this manual should have a solid understanding 
of VAX/VMS operations and administration and VAX application 
oftware. In addition/ a knowledge of the specific 
, equirements of the installation site is essential. 


4. 0 Structure of This Document 


This manual is organized as follows: 

Chapter 1: Gives an overview of the PROGRAMMABLE DEVICE 
SUPPORT system. 

Chapter 2: Describes the PROGRAMMABLE DEVICE SUPPORT 
distribution kit# installation prerequisites/ and the actual 
installation procedure. 

Chapter 3: Contains Release Notes which you should read 
before installing PROGRAMMABLE DEVICE SUPPORT. This chapter 
includes information not included elsewhere in the 
documentation set/ changes made late in the development cycle/ 
software errors# and documentation omissions. 


m 
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Appendix A: Shows a sample installation procadura. 

5. 0 Associatad Documents 

Further information on various topics covered in this 
manual may be found in the following manuals: 

o DECnet VMS Sustem Manager's Guide 

(order number AA-HS03B-TE) 

o BASEWAY Installation Quid e/Release Notes (order 
number XX-12345-01) 

0 SHOP FLOOR GATEWAY Installation Quide/Re1 ease Notes 
(order number XX-12355-01) 

0 BASEWAY Sustem Programmer 7 s Guide 

(order number XX-12346-01) 

o BASEWAY User's Manual and Utilities Guide 

(order number XX-12347-01) 

o PROGRAMMABLE DEVICE SUPPORT User 7 s Manual and 

Utilities Guide 

(order number XX-12367-01) 

o VAX FMS Insta1lation Guide and Release Notes 

(order number AA—L321A—TE) 

o VAX FMS Uti1ities Reference Manua1 

(order number AA—L320A—TE) 

0 VAX PL/I Installation Guide 

(order number AA—J179A-TE) 

o VAX Software Installation Guide 

(order number AA—M545A—TE) 

0 VAX/VMS Command Language User 7 s Guide 

(order number AA-D023B-TE) 





o VAX/VMS Sustem Manager's Guide 
(order number AA-M547A-TE) 


6.0 Disposition of Software Performance Reports (SPRs) 


Questions# problems# and enhancements to Digital software 
should be reported on a Software Performance Report (SPR) form 
and mailed to the appropriate Digital office. Only one 
problem should be described concisely on each SPR form. 
Please include all programs and data in machine-readab1e form 
and reference the SPR form number on the materials. 




CHAPTER 1 


OVERVIEW OF PROGRAMMABLE DEVICE SUPPORT 


PROGRAMMABLE DEVICE SUPPORT is a tool to help you support the 
programmable davicas in your factory. It halps you to examine and 
modify programmabI a davicas. In addition# PROGRAMMABLE DEVICE SUPPORT 
is capabla of providing timely and accurate documentation for all 
supported davicas. 

A "production library" is used by PROGRAMMABLE DEVICE SUPPORT to 
store programs for each programmable device. Individual user 

libraries are also available and#, unless they are explicitly 

authorized to do so# users may never affect the production library. 
Because of this facility# problems caused by typical cassette tape 
storage# such as unreliability# mislabeling# duplication# and loss# 
*e virtually eliminated. 

PROGRAMMABLE DEVICE SUPPORT presents a common device interface to 
all programmable devices. It allows individuals to work from 
terminals connected to the system so that routine tasks such as 
uploading and downloading can be accomplished at a location remote 
from the plant floor. 

Access of all users to programmable device programs is controlled 
and maintained with PROGRAMMABLE DEVICE SUPPORT. Additionally# in the 
event of plant power failure# PROGRAMMABLE DEVICE SUPPORT can 
automatically reload the desired devices. 


1. 1 Programmable Devices Supported 

The following programmable device vendor support is available: 
o A11en-Brad1ey PLC-2/30# PLC-3 
o Mod icon 484# 584 
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Overview of PROGRAMMABLE DEVICE SUPPORT 
1.2 Network Configuration Supported 



I 

I 

I 

I 


I PDP—11/x x ! 
! SHOP FLOOR ! 
I GATEWAY 



!'!! vendor-specific 
! ! S ! protocol 



programmable devices# 
bar code readers# etc 


Figure 1. Typical Configuration 
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1.3 Hardware Requirements 


VAX 11/750 and VAX 11/780 with a minimum of 4 
memory (memory size dependent upon application) 

- VT100 terminals with Advanced Video# or 

terminals 


1.4 Software Requirements 


- VAX/VMS# Version 3. 5 

- BASEWAY# Version 1.0 

- VAX FMS# Version 2. 1 


megabytes of 
VT200-Series 
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CHAPTER 2 


INSTALLING THE SOFTWARE 


The system manager should be familiar with the installation 
process as described herein for use in installing upgrades and 
up dates. 

Depending on the mass storage device and the system load; the 
installation of PROGRAMMABLE DEVICE SUPPORT may take from 20 to 30 
minutes. 


2. 1 Backing Up the System Disk Before Software Installation 


It is recommended that the system disk be backed up prior to 
installation. The. procedure for doing the backup is described in the 
VAX Software Installation Guide. 


2.2 Contents of the Distribution Kit 


The PROGRAMMABLE DEVICE SUPPORT installation kit is distributed 
on magnetic tape. All files required to install the PROGRAMMABLE 
DEVICE SUPPORT system are contained on the distribution. 

Each volume is labeled with an external serial number 
corresponding to the PROGRAMMABLE DEVICE SUPPORT product number and 
has a unique volume label. 

Volume Label Medium Contents 


PDS010 1600 bpi 

magnetic tape 


PROGRAMMABLE DEVICE SUPPORT 
installation procedures 
and software 
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Installing the Software 


NOTH: Be sure to check that the distribution kit you receive 

contains everything listed in the bill of materials enclosed with it. 
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n . 3 Installation Procedure 
2.3.1 Preliminary Requirements 


NOTE: PROGRAMMABLE DEVICE SUPPORT requires VAX/VMS Version 3.5 

or later. 

o approximately 5900 blocks (PROGRAMMABLE DEVICE SUPPORT peak 
usage) during installation 

o approximately 5600 blocks (PROGRAMMABLE DEVICE SUPPORT net 
usage) after installation 

o previous installation of BASEWAY (Version 1.0) and VAX-DECnet 
(Version 3. 0). 


2. 3. 2 Instructions for Installation 


Messages are printed at your terminal during the installation 
procedure. Most are simple ''Yes” or "No" questions which require 
either a Y or N response. 

Proceed as follows at the console terminal (user input is shown 
in uppercase letters): 


2. 3. 2. 1 STEP 1: Log In to the System Manager's Account - 

1. Log in under a privileged system manager's account/ as shown 
in the following example: 

cr 

Username: SYSTEM cr 

Password: cr 


2. Now set up the proper group and user number and set the 
default directory to SYSUPD as follows: 

* SET UIC Cl/41 

* SET DEFAULT SYS$UPDATE 
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2. 3. 2. 2 STEP 2: Invoke VMSINSTAL - 

When you invoke VMSINSTAL* it checks the following: 

o Are you logged into the system manager's account? 

It is recommended that you install layered software from 
the system manager's account. However* any account with the 
necessary privileges is acceptable. 

o Do you have adequate account quotas for installing layered 
products? 

As long as the quotas listed in Section 2. 3. 1 are met* 
you can continue with the installation. 

o Is DECnet up and running? 

You should bring down DECnet before installing BASEWAY. 
Although the installation may succeed* problems can occur if 
someone tries to access any file associated with PROGRAMMABLE 
DEVICE SUPPORT (including the system HELP files) during the 
installation. 

o Are any users logged into the system? 

Users should be asked to log out before PROGRAMMABLE 
DEVICE SUPPORT is installed. Although the installation may 
succeed* problems can occur if someone tries to use 
PROGRAMMABLE DEVICE SUPPORT while the installation is in 
progress. 


If any of 
opportunity to 


these conditions are noted* VMSINSTAL will give you 
stop the installation procedure (see below): 


an 


To invoke VMSINSTAL* enter the following: 


$ 3VMSINSTAL PDSnnn ddn: 


The VMSINSTAL command 


procedure takes two parameters: 


1 . 


product name—for PROGRAMMABLE 
always begins with "PDS" and 
number. For example* Version 1.6 
Hereinafter* this document will 
as Vn. n. 


DEVICE SUPPORT* the name 
ends with a 3-digit version 
would be called PDS016. 
refer to the version number 


2-4 



Installing the Software 



2 . 


device name—device names have the form ddn: / where dd is the 
device code and n is the unit number. For example/ the first 
floppy diskette drive would be called "DYO: 


NOTE: It is not necessary to use the console drive for 
installing PROGRAMMABLE DEVICE SUPPORT. However/ if you do use it/ be 
sure to replace any media you may have found in the drive when the 
installation is complete. 


VAX/VMS Software Product Installation Procedure 


It is dd-mmm-19yy at hh:mm. 

Enter a question mark (?) at any time for help. 

Are you satisfied with the backup of your system disk CYES1? Y 

If you feel that there are conditions which may adversely affect 
the installation/ enter N. To continue/ enter the letter Y (or press 
RETURN). Note that the VMSINSTAL procedure gives the default user 
response in brackets. 


2. 3. 2. 3 STEP 3: Insert the First Installation Kit 
Please mount the first volume of the set on 


Volume - 
ddn: . 


Insert the first volume of the distribution 
drive. Enter "Y" when you are ready to continue, 
explicitly enter a “Y 11 or "N"; pressing RETURN is 
response here. 


kit in the tape 
Note that you must 
not an adequate 


* Are you ready? Y 


The PROGRAMMABLE DEVICE SUPPORT installation procedure now 
assumes control. The procedure checks to see that there is adequate 
disk space to build the product. If not/ it issues an error message 
and terminates. Otherwise/ the procedure processes the first volume 
of the backup save set. 


NOTE: If the SYSGEN parameters MOUNTMSG or DISMCUMSG at your 
site have been set to 1/ you will receive a message from OPCOM each 
time a disk/ tape/ or floppy diskette is mounted or dismounted. These 
messages are normally disabled/ but if they have been activated and 
you are installing from a console terminal/ they will appear from 1 to 
30 seconds after each mount or dismount. 


AMOUNT-I-MOUNTED/ PDSnnn mounted on dnn: 
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The following products will be installed: 

PDS Vn. n 

Boginning installation of PDS Vn. n at hh:mm 
2VMSINSTAL-I-REST0RE* Restoring product saveset A. . . 



At this point* if you need 
procedure* you must press CTRL/Y. 


to exit from the installation 


NOTE: If you press CTRL/Y* the installation procedure deletes 

all files it has created up to that point and exits. 

PDSSTART. COM* the startup command procedure* is used to set up the 
environment for PROGRAMMABLE DEVICE SUPPORT. During installation 
it will be placed in the CSYSMGRJ directory of the system root on 
which this installation is being performed. SYS5MANACER:3YSTARTUP. CO^ 
your system startup procedure* should be modified to invoke this 
procedure when the system boots. However* it will not be necessary 
to reboot the system after the installation* since this procedure 
is invoked as part of the installation. 


2VMSINSTAL-I-MOVEFILES# Files will now be moved to their target 
directories. . . 

The Installation Verification Procedure (IVP) next runs tests to 
check that the installation procedure was successful. 

Installation Verification Procedure (IVP) starting 

The installation verification of PROGRAMMABLE. DEVICE SUPPORT 
vn.n succeeded. 

Successful installation of PDS Vn. n at hh:mm 




PROGRAMMABLE DEVICE SUPPORT images and libraries are 
successfully installed. 


now 


You may now install more products* or you can end the 
installation procedure. To end the installation procedure* type EXIT 
(or press RETURN). 

Enter the products to be installed from the next distribution 
volume set. 

* Products CEXIT3: EXIT 


VMSINSTAL procedure done at hh:mm 
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* 

If you removed any media from the console drive before beginning* 
you can replace it now. 

WARNING: VMSINSTAL deletes symbols and changes entries in the 

logical name tables during the installation. Therefore* if you are 
going to continue using the system manager's account* you should log 
out and log in again to restore those tables. 


2. 3. 3 Error Conditions 


If the installation procedure or IVP fail for any reason* the 
following messages are displayed: 

XVM5INSTALHE—PDSFAIL* The installation of PDS Vn. n has failed. 
%VMSINSTAL-E—IVPFAIL* The IVP for PDS Vn. n has Tailed. 


An error during the installation or IVP can be caused by one or 
more of the following conditions: 

o insufficient disk space to complete the installation 

o insufficient system virtual page count parameter 

o insufficient process paging file quota 

o insufficient process working set quota 

o insufficient system maximum working set 

o corrupt distribution 


To change a system parameter* or to increase an authorized quota 
value* you may need to contact your installation system manager. 


2.4 Backup Procedure After Installation 


After installing PROGRAMMABLE DEVICE SUPPORT you should . back up 
the system disk and save the original for future reference. See the 
VAX Software Installation Guide for information on the proper 
procedur e. 


2-7 



Installing the Software 


2.5 Complete List of Installed Files 


Filename 


Purpose 


SYS*SYSROOT: CSYSMGR3 

PDSSTART.COM PROGRAMMABLE DEVICE SUPPORT startup command file 
SYS*SYSROQT: CSYSMSG3 

PDSMSG. EXE Image file containing PROGRAMMABLE DEVICE SUPPORT 

messages 

SYS*SYSR£}OT: CBSL. SYSTEM3 

EDTUSER.EXE User definition editor image file 
SYSSSYSROOT:CPDS. A1MENU3 


ALLINI. FLB 
COMP. COM 
DEVLADDER. COM 
DEVSTAT. COM 
DOCFILE. COM 
DOWNLOAD. COM 
SENSTAT. COM 
LADDEROUT. COM 
LBDISPLAY. COM 
LIBBRIEF. COM 
LIBCOPY. COM 
LIBDELETE. COM 
LIBFILCMP. COM 
LIBRENAME. COM 
LIBSPOOL. COM 
UPLOAD. COM 
UTLREGDSP. COM 
UTLREGMQD. COM 

SYS$SYSROOT: CPDS. MENU! 


Standard form librar 


Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 

Command 

file 

to 

run 


y for ALL-IN-1 menu support 
COMP image from ALL-IN-1 
DEVLADDER image from ALL-IN-1 
DEVSTAT image from ALL-IN—1 
DOCFILE image from ALL-IN-1 
DOWNLOAD image from ALL-IN-1 
GENSTAT image from ALL-IN-1 
LADDEROUT image from ALL-IN-1 
LBDISPLAY imaoe from ALL—IN—1 
LIBBRIEF image from ALL-IN-1 
LIBCOPY image from ALL-IN—1 
LIBDELETE image from ALL-IN—1 
LIBFILCMP image from ALL-IN—1 
LIBRENAME image from ALL-IN—1 
LIBSPOOL image from ALL-IN-1 
UPLOAD imaae from ALL-IN-1 
UTLREGDSP image from ALL-IN-1 
UTLREGMQD image from ALL-IN-1 


MENU. FLB 


Standard form library for BASEWAY menu driver 


SYS*SYSRGOT: CPDS. SYSTEM3 


1774. MDF 
COMP. EXE 
DEVLADDER. EXE 
DEVSTAT. EXE 


Required file for XLATE image 
"Compare Device Logic" image file 
"Create Ladder Listing" image file 
"Display Detailed Device Status" image file 
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DOCFILE. EXE "Edit Logic Documentation” image file 

DQWNLQAD.EXE "Download Device Logic” image file 
DPF. DAT Required file for XL3 image 

F0R002.DAT Required file for XL3 image 

GENSTAT.EXE "Display Device Status" image file 

GROUPDEF.DAT Group definition data file 

HELP.DAT Required file for XL3 image 

LADDERGUT. EXE "Display Ladder Listing" image file 
LBDISPLAY.EXE "Display Detailed Directory" image file 
LIBBRIEF.EXE "Display Brief Directory" image file 

LIBCOPY.EXE "Copy File" image file 

LIBDELETE. EXE "Delete File" image file 
LIBFILCMP. EXE "Compare Two Files" image file 
LI3PRVC0P. EXE Foreign File Copy image file 
LI3RENAWE. EXE "Rename File" image file 
LIBSPO0L.EXE "Print File” image file 

LL3841.EXE Modicon 184/384 translator image file 

LL3842. EXE Modicon 184/384 translator image file 

LL3843.EXE Modicon 184/384 translator image file 

LL3844. EXE Modicon 184/384 translator image file 

LL484.EXE Modicon 484 translator image file 

LL4842.EXE Modicon 484 translator image file 

LL4843.EXE Modicon 484 translator image file 

LL4844.EXE Modicon 484 translator image file 

LL584.EXE Modicon 584 translator image file 

LL5842.EXE Modicon 584 translator image file 

LL5843. EXE Modicon 584 translator image file 

LL5844.EXE Modicon 584 translator image file 

LL584S.EXE Modicon 584S translator image file 

MENU.DAT Required file for XL3 image 

NULL.IOC Required file for XL2 image 

NULL. QCF Required file for XLATE image 

NULL. STI Required file for XLATE image (null documentation file) 

PATHDEF. DAT Path definition data file 

PATHDIR.DAT Path directory data file 

PATHLIB.DAT Path library data file 

PDSFORMS. FLB Form library for al.l PROGRAMMABLE DEVICE SUPPORT images 

PRMROF. DAT Required file for XL3 image 

PRMTST.DAT Required file for XL3 image 

PROGDIR. DAT Program directory data file 

PRCGLIB. DAT Program library- data file 

UTLREGDSP. EXE "Display Device Memory" image file 

UTLREGMOD. EXE "Modify Device Memory" image file' 

UPLOAD.EXE "Upload Device Logic" image file 

XL2. EXE A1len-Bradley PLC-2 translator image file 

XL2BA. BLK Required file for XL2 

XL2BA. HLP Required file for XL2 

XL2BA. MDF Required file for XL2 

XL2BA.TXT Required file for XL2 

XL2TMPL. ROF Required file for XL2 

XL3. EXE A1len-Bradley PLC-3 translator image file 
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XLATE. EXE 
XLATET1. CMD 
XLATET2. CMD 


A1 len-Bradley PLC translator image file 
Required file for XLATE (template for listing) 
Required file for XLATE (template for full listing) 



CHAPTER 3 


RELEASE NOTES 


This chapter contains information important to the installation 
and operation of PROGRAMMABLE DEVICE SUPPORT. 


3.1 PROGRAMMABLE DEVICE SUPPORT User Editor 


When PROGRAMMABLE DEVICE SUPPORT is installed on a system/ the 
standard BASEWAY user definition editor is replaced by a PROGRAMMABLE 
DEVICE SUPPORT user editor. The PROGRAMMABLE DEVICE SUPPORT editor is 
functionally identical to the BASEWAY editor/ except for the "LIBRARY” 
field: 

o The BASEWAY editor treats this field as a "documentation" 
field/ and performs no action based on this field except 
saving the contents in the user record. 

o The PROGRAMMABLE DEVICE SUPPORT editor treats this field as a 
PROGRAMMABLE DEVICE SUPPORT library specification/ and 
creates a PROGRAMMABLE DEVICE SUPPORT user library record and 
a VMS directory based on the value of the field. 


I 

editor 
any pr 
with 
(Updat 


f PROGRAMMABLE DEVICE SUPPORT users 
before the product is installed/ 
ograms. To alleviate this problem/ 
the PROGRAMMABLE DEVICE SUPPORT 
e) to create the necessary records 


are def 
they mil 
simply 
editor 
and dire 


i 

1 

c 

c 


ned with 
be unab 
all up 
and pre 
tor i es. 


the BASEWAY 
le to access 
these users 
ss Keypad 7 
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3.2 Problem with PLC-2 and PLC—3 Loads 


During both downloads and 
device gets allocated but tb 
upload or download* other u 
disabled from accessing the 
finished* the PLC device uploa 
release the device to the 1771 
the mode of operation of th 
A1len—Brad ley. 


uploads on PLC-2 and PLC-3 devices* the 
e 177J-KA card For the duration of the 


sers <i. e. * industrial 
device. After the upload 
d/download routines send 
-KA card. This procedure 
e 1771-KA card and is 


terminal) are 
or download is 
a command to 
is required by 
specified by 


If the up load/download is terminated prematurely by forcing the 
program to exit < e. g. * stopping the process)* the 1771-KA card 
will be left with the industrial terminal port in a disabled mode. In 
order to reenable it* the KA card must either be reset by powering it 
down or the aborted operation must be reexecuted. 

Of course* if a download is aborted* the PLC will be in an 
undetermined state and* must be reloaded with a correct program. 


3. 3 


Problem with Multiple 


Translators 


When a ladder listing is created* a vendor-supplied translation 
program is usually run to do the translation. These programs create a 
number of temporary work files while translating. Un.fortunately* the 
file names are fixed in the vendor code* and cannot be.changed by 
Digital. 

With PROGRAMMABLE DEVICE SUPPORT* translation programs run out of 
the user's PROGRAMMABLE DEVICE SUPPORT library. Thus* temporary work 
files are created in the program library* and deleted when the 
translation is finished. 

If a user tried to do two translations simultaneously* or if two 
users had the same PROGRAMMABLE DEVICE SUPPORT library* the results 
would be unpredictable* since the files are opened and closed several 
times during execution and they would get mixed up between the 
translators. 

Because of this* the PROGRAMMABLE DEVICE SUPPORT system will not 
currently allow a user to run more than one translation at a time for 
any single programmable device vendor <fortunately* different vendors 
used different file names). PROGRAMMABLE DEVICE SUPPORT does not 
check to see if more than one user has the same PROGRAMMABLE DEVICE 
SUPPORT library defined. If two users have the same PROGRAMMABLE 
DEVICE SUPPORT library* and they do translates at the same time* the 
re-sults are unpr ed ic tab 1 e. This restriction will be removed as PLC 
vendors insure that file names are process ID—based and unique. 



APPENDIX A 


SAMPLE INSTALLATION PROCEDURE 


* SET UIC Cl, 43 

* SET DEFAULT SYS*UPDATE 

* SVMSINSTAL PDSOIO MSAO: 


VAX/VMS Software Product Installation Procedure 


It is l-JUN-1994 at 12:05. 

Enter a question mark (?) at any time for help. 

* Are you satisfied with the backup of your system disk CYE53? YES 

please mount the first volume of the set on MSAO:. 

* Are you ready? YES 

‘/.MOUNT-1 -MOUNTED, PDSOIO mounted on _MSAO: 

The following products will be installed: 

PDS VI. 0 


Beginning installation of PDS VI. 0 at 12:07 

XVMSINSTAL-I-RESTORE, Restoring product saveset A... 

PDSSTART.COM, the startup command procedure, is used to set up the 
environment for PROGRAMMABLE DEVICE SUPPORT. During installation 
it will be placed in the CSYSMGR3 directory of the system root on 
which this installation is being performed. SYS*MANAGER:SYSTARTUP. COM 
your system startup procedure, should be modified to invoke this 
procedure when the system boots. However, it will not be necessary 
to reboot the system after the installation, since this procedure 
is invoked as part of the insta1lation. 



Sample Installation Procedure 


%VMSINSTAL-I-MOVEFILES* Files will now be moved to their target 

directories. . 

Installation Verification Procedure (IVP) starting 

The installation verification of PROGRAMMABLE DEVICE SUPPORT VI. 0 

succeeded. 

Successful installation of PDS VI. 0 at 12:32 

Enter the products to be installed from the next distribution 

volume set. 

* Products CEXIT3: EXIT 

VMSINSTAL procedure done at 12:35 
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